home *** CD-ROM | disk | FTP | other *** search
/ IRIX Installation Tools & Overlays 1999 May / SGI IRIX Installation Tools & Overlays 1999 May - Disc 2.iso / relnotes / insight / ch2.z / ch2
Text File  |  1999-04-19  |  35KB  |  721 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        2.  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  9.  
  10.        This chapter lists supplemental information to the _I_R_I_S
  11.        _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e.  The information listed here is
  12.        product- and release-specific; use it with the Installation
  13.        Guide to install this product.
  14.  
  15.  
  16.        2.1  _I_R_I_S__I_n_S_i_g_h_t__S_u_b_s_y_s_t_e_m_s
  17.  
  18.        The IRIS InSight product family includes these subsystems:
  19.  
  20.        _i_n_s_i_g_h_t._b_o_o_k_s._V_i_e_w_e_r_H_e_l_p      SGIHelp (Desktop Help) Help
  21.                                      Book, 4.1
  22.  
  23.        _i_n_s_i_g_h_t._b_o_o_k_s._h_e_l_p            InSight Online Doc Viewer Help
  24.                                      Book, 4.1
  25.  
  26.        _i_n_s_i_g_h_t._m_a_n._m_a_n               InSight Online Doc Viewer and
  27.                                      SGIHelp Man Pages, 4.1
  28.  
  29.        _i_n_s_i_g_h_t._m_a_n._r_e_l_n_o_t_e_s          InSight Online Doc Viewer and
  30.                                      SGIHelp Release Notes, 4.1
  31.  
  32.        _i_n_s_i_g_h_t._m_a_n._s_g_i_h_e_l_p__d_e_v       SGIHelp Development Man Pages,
  33.                                      4.1
  34.  
  35.        _i_n_s_i_g_h_t._m_a_n._x_h_e_l_p__d_e_v         SGIHelp XHelp Development Man
  36.                                      Pages, 4.1
  37.  
  38.        _i_n_s_i_g_h_t._s_w._c_l_i_e_n_t             InSight Online Doc Viewer, 4.1
  39.  
  40.        _i_n_s_i_g_h_t._s_w._d_a_t_a               InSight Online Doc Viewer
  41.                                      Shared Data, 4.1
  42.  
  43.        _i_n_s_i_g_h_t._s_w._j_a_p_a_n_e_s_e           InSight Online Doc Viewer
  44.                                      Japanese Data, 4.1
  45.  
  46.        _i_n_s_i_g_h_t._s_w._s_g_i_h_e_l_p            SGIHelp (Help System) and
  47.                                      DesktopHelp Software, 4.1
  48.  
  49.        _i_n_s_i_g_h_t._s_w._s_g_i_h_e_l_p__d_e_v        SGIHelp Header & Library
  50.                                      Files, 4.1
  51.  
  52.        _i_n_s_i_g_h_t._s_w._x_h_e_l_p__d_e_v          SGIHelp XHelp Shared Tools,
  53.                                      4.1
  54.  
  55.        Help content for the IRIX Interactive Desktop(TM) is
  56.        retrieved from a variety of IRIS InSight books. A partial
  57.        list is shown here:
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        _d_e_s_k_t_o_p__e_o_e._b_o_o_k_s.*           IRIX Interactive Desktop(TM)
  75.                                      Books
  76.  
  77.        _d_m_e_d_i_a__e_o_e._b_o_o_k_s.*            Digital Media Books
  78.  
  79.        _e_o_e._b_o_o_k_s.*                   IRIX Execution Environment
  80.                                      Books
  81.  
  82.        _i_m_g_t_o_o_l_s._b_o_o_k_s.*              ImageVision Tools User's Guide
  83.                                      and Help
  84.  
  85.        _i_m_p_r__b_a_s_e._b_o_o_k_s.*             Impressario (Printing and
  86.                                      Scanning) Books
  87.  
  88.        _i_n_f_o_s_e_a_r_c_h._b_o_o_k_s._h_e_l_p         Information Searching Help
  89.  
  90.        _i_n_s_i_g_h_t._b_o_o_k_s._h_e_l_p            InSight Online Doc Viewer Help
  91.  
  92.        _i_n_s_i_g_h_t._b_o_o_k_s._V_i_e_w_e_r_H_e_l_p      SGIHelp (Desktop Help) Help
  93.                                      Book
  94.  
  95.        _i_n_s_i_g_h_t__g_l_o_s_s._b_o_o_k_s._g_l_o_b_a_l    IRIS InSight Glossary of Terms
  96.  
  97.        _s_y_s_m_o_n._b_o_o_k_s.*                Desktop System Monitor Help
  98.  
  99.  
  100.        2.2  _I_R_I_S__I_n_S_i_g_h_t__S_u_b_s_y_s_t_e_m__D_i_s_k__S_p_a_c_e__R_e_q_u_i_r_e_m_e_n_t_s
  101.  
  102.        This section lists the subsystems (and their sizes) of the
  103.        IRIS InSight software.
  104.  
  105.        You can use the software installation instructions in the
  106.        _P_e_r_s_o_n_a_l _S_y_s_t_e_m _A_d_m_i_n_i_s_t_r_a_t_i_o_n _G_u_i_d_e to install this
  107.        product.  If you are installing this software for the first
  108.        time, the default subsystems are installed if you click the
  109.        _I_n_s_t_a_l_l _A_u_t_o_m_a_t_i_c_a_l_l_y button.  To install a different set of
  110.        subsystems, click the _C_u_s_t_o_m_i_z_e _I_n_s_t_a_l_l_a_t_i_o_n button and make
  111.        your new selections.  Then click the _S_t_a_r_t button to launch
  112.        the installation.
  113.  
  114.        Note:  The listed subsystem sizes are approximate. Refer to
  115.               the _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e for
  116.               information on finding exact sizes.
  117.  
  118.        Subsystem Name                Subsystem Size
  119.                                      (Kilobytes)
  120.        _i_n_s_i_g_h_t._b_o_o_k_s._V_i_e_w_e_r_H_e_l_p            380
  121.        _i_n_s_i_g_h_t._b_o_o_k_s._h_e_l_p                  468
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                                   - 3 -
  136.  
  137.  
  138.  
  139.        _i_n_s_i_g_h_t._m_a_n._m_a_n                      28
  140.        _i_n_s_i_g_h_t._m_a_n._r_e_l_n_o_t_e_s                 56
  141.        _i_n_s_i_g_h_t._m_a_n._s_g_i_h_e_l_p__d_e_v               8
  142.        _i_n_s_i_g_h_t._m_a_n._x_h_e_l_p__d_e_v                 8
  143.        _i_n_s_i_g_h_t._s_w._c_l_i_e_n_t                 10016
  144.        _i_n_s_i_g_h_t._s_w._d_a_t_a                      12
  145.        _i_n_s_i_g_h_t._s_w._j_a_p_a_n_e_s_e                  64
  146.        _i_n_s_i_g_h_t._s_w._s_g_i_h_e_l_p                   14.1
  147.        _i_n_s_i_g_h_t._s_w._s_g_i_h_e_l_p__d_e_v               20
  148.        _i_n_s_i_g_h_t._s_w._x_h_e_l_p__d_e_v                940
  149.  
  150.  
  151.  
  152.        2.3  _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d
  153.  
  154.        All of the subsystems for IRIS InSight can be installed
  155.        using IRIX.  You do not need to use the miniroot. Refer to
  156.        the _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for complete
  157.        installation instructions.
  158.  
  159.  
  160.        2.4  _P_r_e_r_e_q_u_i_s_i_t_e_s
  161.  
  162.        Your workstation must be running IRIX 6.2 or greater in
  163.        order to use this release of IRIS InSight.
  164.  
  165.        Most products in the IRIS InSight family require that the
  166.        insight_base product be installed. In particular, the
  167.        _i_n_s_i_g_h_t__b_a_s_e._s_w._e_o_e subsystem.
  168.  
  169.        If you install the IRIS InSight viewer (_i_n_s_i_g_h_t._s_w._c_l_i_e_n_t)
  170.        then you must also install _x__e_o_e._s_w._e_o_e, _m_o_t_i_f__e_o_e._s_w._e_o_e,
  171.        _d_m_e_d_i_a__e_o_e._s_w._l_i_b, _c_o_m_p_i_l_e_r__e_o_e._s_w._l_i_b, _c++__e_o_e._s_w._l_i_b, and
  172.        _V_i_e_w_K_i_t__e_o_e._s_w._b_a_s_e for the viewer to function properly.
  173.  
  174.        If you want to view any of the inline Inventor media objects
  175.        then you must install _i_n_v_e_n_t_o_r__e_o_e._s_w._i_n_v_e_n_t_o_r.  If you want
  176.        to view any of the inline movie objects then you must
  177.        install _e_o_e._s_w._g_f_x.
  178.  
  179.        Many of the aforementioned prerequisites also apply to
  180.        installing the SGIHelp viewer, _i_n_s_i_g_h_t._s_w._s_g_i_h_e_l_p. In
  181.        addition, the SGIHelp viewer requires that _w_e_b_v_i_e_w_e_r._s_w._e_o_e
  182.        be installed.
  183.  
  184.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                   - 4 -
  197.  
  198.  
  199.  
  200.        If you want to install the online help book
  201.        (_i_n_s_i_g_h_t._b_o_o_k_s._h_e_l_p) for the IRIS InSight viewer then you
  202.        must install the SGIHelp viewer _i_n_s_i_g_h_t._s_w._s_g_i_h_e_l_p along
  203.        with the help.
  204.  
  205.        If you wish to install the SGIHelp XHelp tools then you will
  206.        need to install _i_n_s_t__d_e_v._s_w._b_a_s_e, and _d_e_v._s_w._m_a_k_e (which are
  207.        part of the base Developer bundle), in order to build
  208.        instable images.  If you simply want to build the samples
  209.        without building images then you do not need these
  210.        subsystems.
  211.  
  212.  
  213.        2.5  _C_o_m_p_a_t_i_b_i_l_i_t_y
  214.  
  215.        It is possible to mount and access books from a machine
  216.        running a different version of IRIX. In general, to avoid
  217.        any incompatibilities, the client machine should have
  218.        version 3.x (or greater) of the InSight Viewer (and version
  219.        3.x, or greater, of SGIHelp) installed.  In this scenario,
  220.        the help for certain applications may not work properly due
  221.        to changes in both the applications themselves and in the
  222.        documentation (between the different versions of IRIX).
  223.  
  224.        Japanese books cannot be viewed using a version 2.x InSight
  225.        Viewer and _m_u_s_t be viewed using a version 3.x (or greater)
  226.        viewer.
  227.  
  228.        The new InSight Viewer and SGIHelp can view all books
  229.        distributed as part of IRIX 6.2, 6.3, 6.4 or 6.5.  The
  230.        opposite may not be true (in general, the 2.x versions of
  231.        InSight cannot read books published for IRIX 6.3, 6.4 and
  232.        6.5).
  233.  
  234.  
  235.        2.6  _O_t_h_e_r__I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  236.  
  237.        Important: Please read this section carefully.  It details
  238.                   installation information specific to the IRIS
  239.                   InSight product.
  240.  
  241.        You can install IRIS InSight in various configurations:
  242.  
  243.           +o Client and Local Books
  244.  
  245.           +o Client with Remote (mounted) Books
  246.  
  247.           +o Client Accessing Books from a CD-ROM
  248.  
  249.           +o Creating an InSight Library Server for Clients to
  250.             Access
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                                   - 5 -
  263.  
  264.  
  265.  
  266.           +o Client Accessing Books from Multiple Locations
  267.  
  268.        2.6.1  _C_l_i_e_n_t__a_n_d__L_o_c_a_l__B_o_o_k_s
  269.  
  270.        The default installation configuration is to install the
  271.        IRIS InSight Viewer and Library on a single system. The
  272.        total size of the viewer (and help book for the viewer) is
  273.        approximately 11 megabytes. Installing additional books
  274.        requires additional disk space.  If you have the disk space,
  275.        this is the ideal configuration since it gives the viewer
  276.        fastest access to the book data.
  277.  
  278.        See the Release Notes for products that contain books to
  279.        find out the disk space requirements for each book.
  280.  
  281.  
  282.        2.6.2  _L_o_c_a_l__C_l_i_e_n_t__w_i_t_h__R_e_m_o_t_e__(_m_o_u_n_t_e_d_)__B_o_o_k_s
  283.  
  284.        If several machines plan on sharing all the books and help
  285.        files via NFS mounts then this is the configuration of
  286.        choice.
  287.  
  288.        Note:  If you have the IRIS InSight Library (books)
  289.               installed on your disk but wish to mount the books
  290.               from a remote machine, you should remove all the
  291.               current IRIS InSight books (with the IRIX command
  292.               _v_e_r_s_i_o_n_s _r_e_m_o_v_e) from your system and remove any
  293.               remaining files in /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y before
  294.               performing the mount command described below.
  295.  
  296.        To install the IRIS InSight Viewer and Library on a remote
  297.        server and access the information from a local client
  298.        system, follow these steps:
  299.  
  300.          1.  On the server:
  301.  
  302.                a.  Install the complete IRIS InSight product image
  303.                    and all books.  See "Creating an InSight Library
  304.                    Server for Clients to Access" in this section
  305.                    for further details.
  306.  
  307.                    IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll iiiinnnnssssiiiigggghhhhtttt ****....bbbbooooooookkkkssss....****
  308.  
  309.                b.  Export the /_u_s_r/_s_h_a_r_e directory using the System
  310.                    Manager.
  311.  
  312.          2.  On the client:
  313.  
  314.                a.  Install the _i_n_s_i_g_h_t._s_w._c_l_i_e_n_t subsystem (you
  315.                    might want to install the _i_n_s_i_g_h_t._m_a_n._r_e_l_n_o_t_e_s
  316.                    subsystem as well).
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                                   - 6 -
  329.  
  330.  
  331.  
  332.                    IIIInnnnsssstttt>>>> kkkkeeeeeeeepppp iiiinnnnssssiiiigggghhhhtttt
  333.                    IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll iiiinnnnssssiiiigggghhhhtttt....sssswwww....cccclllliiiieeeennnntttt
  334.  
  335.                b.  Mount <_s_e_r_v_e_r>:/_u_s_r/_s_h_a_r_e on /_u_s_r/_s_h_a_r_e.
  336.  
  337.                    mmmmoooouuuunnnntttt <<<<sssseeeerrrrvvvveeeerrrr>>>>::::////uuuussssrrrr////sssshhhhaaaarrrreeee ////uuuussssrrrr////sssshhhhaaaarrrreeee
  338.  
  339.  
  340.        2.6.3  _C_l_i_e_n_t__A_c_c_e_s_s_i_n_g__B_o_o_k_s__f_r_o_m__a__C_D_-_R_O_M
  341.  
  342.        Note:  If you have the IRIS InSight Library (books)
  343.               installed on your disk but wish to mount the books
  344.               from the CD-ROM, you should remove all the current
  345.               IRIS InSight books (with the IRIX command _v_e_r_s_i_o_n_s
  346.               _r_e_m_o_v_e) from your system and remove any remaining
  347.               files in /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y before creating
  348.               the symbolic link described in step 2.
  349.  
  350.        If you wish to use the IRIS InSight Viewer and Library from
  351.        the CD-ROM and access the information from a local system,
  352.        follow these steps:
  353.  
  354.          1.  On the system with the CD-ROM drive, insert the CD
  355.              that contains an IRIS InSight Library (books) into the
  356.              CD-ROM drive.
  357.  
  358.              If the drive is not mounted, use the System Manager to
  359.              mount the drive.  The most common mount point is
  360.              /_C_D_R_O_M.
  361.  
  362.              If the drive is mounted correctly, you should be able
  363.              to change directories to /_C_D_R_O_M and see the directory
  364.              containing the IRIS InSight Library (books) on the CD
  365.              (for example, a directory called "insight"):
  366.  
  367.              ccccdddd ////CCCCDDDDRRRROOOOMMMM
  368.              llllssss
  369.  
  370.          2.  As root, create a symbolic link from
  371.              /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y/_S_G_I__b_o_o_k_s_h_e_l_v_e_s to the CD
  372.              mount point for the _i_n_s_i_g_h_t directory.  You may need
  373.              to create the directory /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y if
  374.              it doesn't exist.
  375.  
  376.              mmmmkkkkddddiiiirrrr ----pppp ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy
  377.              llllnnnn ----ssss ////CCCCDDDDRRRROOOOMMMM////iiiinnnnssssiiiigggghhhhtttt////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss
  378.                    ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss
  379.  
  380.          3.  As root create a symbolic link from /_u_s_r/_s_h_a_r_e/_h_e_l_p to
  381.              the CD mount point for the _h_e_l_p directory (if one
  382.              exists).
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.                                   - 7 -
  395.  
  396.  
  397.  
  398.              llllnnnn ----ssss ////CCCCDDDDRRRROOOOMMMM////hhhheeeellllpppp ////uuuussssrrrr////sssshhhhaaaarrrreeee////hhhheeeellllpppp
  399.  
  400.              If you are sharing this CD-ROM mount point with other
  401.              users on your network, export the root (``/'')
  402.              directory and the /_C_D_R_O_M directory using the System
  403.              Manager.
  404.  
  405.          4.  On each client:
  406.  
  407.                a.  Install the _i_n_s_i_g_h_t._s_w._c_l_i_e_n_t and
  408.                    _i_n_s_i_g_h_t._s_w._d_a_t_a subsystems (you might want to
  409.                    install the _i_n_s_i_g_h_t._m_a_n._m_a_n and the
  410.                    _i_n_s_i_g_h_t._m_a_n._r_e_l_n_o_t_e_s subsystems as well). For
  411.                    example:
  412.  
  413.                    ssssuuuu
  414.                    iiiinnnnsssstttt ----ffff ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt
  415.                    IIIInnnnsssstttt>>>> kkkkeeeeeeeepppp ****
  416.                    IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll iiiinnnnssssiiiigggghhhhtttt....sssswwww....cccclllliiiieeeennnntttt iiiinnnnssssiiiigggghhhhtttt....sssswwww....ddddaaaattttaaaa
  417.                    IIIInnnnsssstttt>>>> ggggoooo
  418.  
  419.  
  420.                b.  If you are mounting the CD-ROM from a remote
  421.                    system, as root, mount <_c_d-
  422.                    _s_e_r_v_e_r>:/_C_D_R_O_M/_i_n_s_i_g_h_t/_S_G_I__b_o_o_k_s_h_e_l_v_e_s on
  423.                    /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y/_S_G_I__b_o_o_k_s_h_e_l_v_e_s. You
  424.                    may need to create the directory
  425.                    /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y/_S_G_I__b_o_o_k_s_h_e_l_v_e_s if it
  426.                    doesn't exist.
  427.  
  428.                    mmmmkkkkddddiiiirrrr ----pppp ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss
  429.                    mmmmoooouuuunnnntttt <<<<ccccdddd----sssseeeerrrrvvvveeeerrrr>>>>::::////CCCCDDDDRRRROOOOMMMM////iiiinnnnssssiiiigggghhhhtttt////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss \\\\
  430.                    ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss
  431.  
  432.                c.  If you are mounting the CD-ROM from a remote
  433.                    system, mount <_c_d-_s_e_r_v_e_r>:/_C_D_R_O_M/_h_e_l_p on
  434.                    /_u_s_r/_s_h_a_r_e/_h_e_l_p. You may need to create the
  435.                    directory /_u_s_r/_s_h_a_r_e/_h_e_l_p if it doesn't exist.
  436.  
  437.                    mmmmkkkkddddiiiirrrr ----pppp ////uuuussssrrrr////sssshhhhaaaarrrreeee////hhhheeeellllpppp
  438.                    mmmmoooouuuunnnntttt <<<<ccccdddd----sssseeeerrrrvvvveeeerrrr>>>>::::////CCCCDDDDRRRROOOOMMMM////hhhheeeellllpppp ////uuuussssrrrr////sssshhhhaaaarrrreeee////hhhheeeellllpppp
  439.  
  440.  
  441.  
  442.        2.6.4  _C_r_e_a_t_i_n_g _a_n _I_n_S_i_g_h_t _L_i_b_r_a_r_y _S_e_r_v_e_r _f_o_r _C_l_i_e_n_t_s _t_o
  443.        _A_c_c_e_s_s
  444.  
  445.        For sites with numerous SGI machines running multiple
  446.        versions of the IRIX operating system, it may be
  447.        advantageous to devote one machine to being an InSight
  448.        Library Server. This server would contain all the books for
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.                                   - 8 -
  461.  
  462.  
  463.  
  464.        the various IRIX releases, and the clients would simply NFS
  465.        mount the appropriate books and help from that server.
  466.  
  467.        To create an InSight Library server, start by installing the
  468.        version of InSight and all the books for the oldest OS
  469.        version that any client machine will want to mount. For
  470.        instance, if the server will contain the IRIX 6.5 and 6.4
  471.        books, then install the IRIX 6.4 version of InSight and the
  472.        6.4 books initially.
  473.  
  474.        After the books are installed for a particular version of
  475.        IRIX, move the "library" directory to
  476.        "<IRIX_Version>library" so that the next installation
  477.        doesn't overwrite the books. If you are installing only one
  478.        version of books (for one version of IRIX), this step is not
  479.        necessary.
  480.  
  481.        The "library" directory is found under /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/.
  482.        You will also need to move the Help-specific files installed
  483.        in /usr/share/help. For example:
  484.  
  485.        ssssuuuu
  486.        ccccdddd ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt
  487.        mmmmvvvv lllliiiibbbbrrrraaaarrrryyyy 6666....4444lllliiiibbbbrrrraaaarrrryyyy
  488.        ccccdddd ////uuuussssrrrr////sssshhhhaaaarrrreeee
  489.        mmmmvvvv hhhheeeellllpppp 6666....4444hhhheeeellllpppp
  490.  
  491.        Continue to follow this process for any number of versions
  492.        of the books (any number of IRIX versions), you wish to
  493.        install on the server.  If you ever need to install more
  494.        books on a specific OS ("operating system"; the version of
  495.        IRIX) bookshelf then create a symbolic link from the proper
  496.        "library" directory to the OS-specific library directory.
  497.        For help books you will also need to create a link for the
  498.        "help" directory as well!
  499.  
  500.        Here is what a potential Library Server would look like
  501.        after installing the 6.5 and 6.4 books:
  502.  
  503.        llllssss ----llll ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt
  504.  
  505.        ttttoooottttaaaallll 22224444
  506.        ddddrrrrwwwwxxxxrrrr----xxxxrrrr----xxxx  3333 rrrrooooooootttt  ssssyyyyssss  555511112222 AAAAuuuugggg  2222 11116666::::44441111  6666....4444lllliiiibbbbrrrraaaarrrryyyy
  507.        ddddrrrrwwwwxxxxrrrr----xxxxrrrr----xxxx  5555 rrrrooooooootttt  ssssyyyyssss  555511112222 AAAAuuuugggg  2222 11118888::::44441111  6666....5555lllliiiibbbbrrrraaaarrrryyyy
  508.        ddddrrrrwwwwxxxxrrrr----xxxxrrrr----xxxx  3333 rrrrooooooootttt  ssssyyyyssss  555511112222 SSSSeeeepppp 11113333 11118888::::22221111  lllliiiibbbb
  509.        llllrrrrwwwwxxxxrrrrwwwwxxxxrrrr----xxxx  1111 rrrrooooooootttt  ssssyyyyssss  11110000  AAAAuuuugggg  2222 11119999::::33331111  lllliiiibbbbrrrraaaarrrryyyy ---->>>> 6666....5555lllliiiibbbbrrrraaaarrrryyyy
  510.        ----rrrr--------rrrr--------rrrr--------  1111 rrrrooooooootttt  ssssyyyyssss  222299990000 SSSSeeeepppp 11113333 11117777::::55556666  ssssyyyysssstttteeeemmmm....iiiinnnnssssiiiigggghhhhttttrrrrcccc
  511.        ddddrrrrwwwwxxxxrrrrwwwwxxxxrrrrwwwwxxxx  2222 rrrrooooooootttt  ssssyyyyssss  555511112222 OOOOcccctttt 22226666 11114444::::22228888  ttttmmmmpppp
  512.  
  513.        llllssss ----llll ////uuuussssrrrr////sssshhhhaaaarrrreeee////****hhhheeeellllpppp
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.                                   - 9 -
  527.  
  528.  
  529.  
  530.        ttttoooottttaaaallll 22224444
  531.        ddddrrrrwwwwxxxxrrrr----xxxxrrrr----xxxx  3333 rrrrooooooootttt  ssssyyyyssss  555511112222 AAAAuuuugggg  2222 11116666::::44441111  6666....4444hhhheeeellllpppp
  532.        ddddrrrrwwwwxxxxrrrr----xxxxrrrr----xxxx  5555 rrrrooooooootttt  ssssyyyyssss  555511112222 AAAAuuuugggg  2222 11118888::::44441111  6666....5555hhhheeeellllpppp
  533.        llllrrrrwwwwxxxxrrrrwwwwxxxxrrrr----xxxx  1111 rrrrooooooootttt  ssssyyyyssss  11110000  AAAAuuuugggg  2222 11119999::::33331111  hhhheeeellllpppp ---->>>> 6666....5555hhhheeeellllpppp
  534.  
  535.        After the server is set up, all the various OS-specific
  536.        clients need to install the proper InSight client (viewer)
  537.        software on their system and NFS mount the OS-specific
  538.        library and help directory.
  539.  
  540.        Follow the instructions in these release notes for how to
  541.        install for a "Client with a Remote (mounted) Books", except
  542.        mount the OS-specific version of the libraries rather than
  543.        the "library" directory.
  544.  
  545.        The following illustrates the specific mount commands a
  546.        client would use given the sample Library Server specified
  547.        above.
  548.  
  549.        For an IRIX 6.5 client:
  550.  
  551.        ssssuuuu
  552.        mmmmoooouuuunnnntttt <<<<sssseeeerrrrvvvveeeerrrr>>>>::::////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////6666....5555lllliiiibbbbrrrraaaarrrryyyy ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy
  553.        mmmmoooouuuunnnntttt <<<<sssseeeerrrrvvvveeeerrrr>>>>::::////uuuussssrrrr////sssshhhhaaaarrrreeee////6666....5555hhhheeeellllpppp            ////uuuussssrrrr////sssshhhhaaaarrrreeee////hhhheeeellllpppp
  554.  
  555.        For an IRIX 6.4 client:
  556.  
  557.        ssssuuuu
  558.        mmmmoooouuuunnnntttt <<<<sssseeeerrrrvvvveeeerrrr>>>>::::////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////6666....4444lllliiiibbbbrrrraaaarrrryyyy ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy
  559.        mmmmoooouuuunnnntttt <<<<sssseeeerrrrvvvveeeerrrr>>>>::::////uuuussssrrrr////sssshhhhaaaarrrreeee////6666....4444hhhheeeellllpppp            ////uuuussssrrrr////sssshhhhaaaarrrreeee////hhhheeeellllpppp
  560.  
  561.        If one mount point is desired (for example, /_u_s_r/_s_h_a_r_e) then
  562.        InSight can be run in such as way as to force it to look at
  563.        a particular library using the -l <library> command-line
  564.        option:
  565.  
  566.        iiiinnnnssssiiiigggghhhhtttt ----llll ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////6666....5555lllliiiibbbbrrrraaaarrrryyyy
  567.        iiiinnnnssssiiiigggghhhhtttt ----llll ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////6666....4444lllliiiibbbbrrrraaaarrrryyyy
  568.  
  569.  
  570.  
  571.        2.6.5  _C_l_i_e_n_t__A_c_c_e_s_s_i_n_g__B_o_o_k_s__f_r_o_m__M_u_l_t_i_p_l_e__L_o_c_a_t_i_o_n_s
  572.  
  573.        It is possible to access books from multiple locations in
  574.        IRIS InSight.  This is useful, for example, if you want to
  575.        access the books available on the IRIX 6.5 CD-ROM along with
  576.        the books installed locally on your system disk.  Due to the
  577.        complexity of this configuration, this kind of setup should
  578.        only be attempted by InSight administrators that understand
  579.        the intricacies of InSight book administration.  We
  580.        recommend that you instead set up an InSight Library Server
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.                                   - 10 -
  593.  
  594.  
  595.  
  596.        as mentioned in the previous section.
  597.  
  598.        To do so involves making the appropriate mounts and links in
  599.        the /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y directory so that InSight
  600.        will find the books.  IRIS InSight assumes that every
  601.        subdirectory of /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y/_S_G_I__b_o_o_k_s_h_e_l_v_e_s
  602.        is a directory of bookshelves. For example, you may find a
  603.        directory called "SGI_EndUser" containing the end user
  604.        books.
  605.  
  606.        Note:  If you have any of the European language books
  607.               installed then "SGI_bookshelves" will be
  608.               "de_bookshelves" for the German version of the books
  609.               and "fr_bookshelves" for the French versions of the
  610.               books.
  611.  
  612.        Each bookshelf directory contains a set of books, via
  613.        subdirectories and files.  It is important to note that each
  614.        bookshelf is an integral unit and you cannot access
  615.        individual books on it via links.  However, you can
  616.        configure the books available on a bookshelf by selecting or
  617.        deselecting the appropriate books through _i_n_s_t.
  618.  
  619.        To add a new bookshelf to IRIS InSight, it is sufficient to
  620.        make a link or mount a bookshelf directory in
  621.        /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y/_S_G_I__b_o_o_k_s_h_e_l_v_e_s.
  622.  
  623.        For example, if you don't have the SGI_Admin bookshelf
  624.        installed on your hard disk and you want to access it
  625.        directly from the IRIX 6.5 CD-ROM, do the following:
  626.  
  627.        ssssuuuu
  628.        llllnnnn ----ssss ////CCCCDDDDRRRROOOOMMMM////iiiinnnnssssiiiigggghhhhtttt////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss////SSSSGGGGIIII____AAAAddddmmmmiiiinnnn \\\\
  629.        ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss////SSSSGGGGIIII____AAAAddddmmmmiiiinnnn
  630.  
  631.        Note:  These instructions assume the CD-ROM is mounted as
  632.               /_C_D_R_O_M.
  633.  
  634.        The next time IRIS InSight is started it will now read the
  635.        SGI_Admin bookshelf from the CD-ROM along with any books
  636.        that were already on your hard disk.
  637.  
  638.        In this manner, any number of bookshelves may be added or
  639.        removed from IRIS InSight.
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.                                   - 11 -
  659.  
  660.  
  661.  
  662.        2.7  _E_x_e_c_u_t_i_o_n__A_f_t_e_r__I_n_s_t_a_l_l_a_t_i_o_n
  663.  
  664.        After the software has been installed, you might want to
  665.        force your shell to re-cache its list of known executables:
  666.  
  667.        rrrreeeehhhhaaaasssshhhh
  668.  
  669.        You can then execute the IRIS InSight Viewer.  It is known
  670.        as _i_n_s_i_g_h_t, or _i_i_v for short.  _i_i_v stands for IRIS InSight
  671.        Viewer.  The Viewer process places itself in the background
  672.        by default.
  673.  
  674.        iiiiiiiivvvv
  675.  
  676.  
  677.  
  678.        2.8  _M_a_i_n_t_e_n_a_n_c_e__A_f_t_e_r__R_e_m_o_v_i_n_g__B_o_o_k_s
  679.  
  680.        The installation of books causes several commands to be
  681.        executed during the exitop phase to create a library level
  682.        index for each bookshelf.  If you remove books using the
  683.        _v_e_r_s_i_o_n_s _r_e_m_o_v_e command, the books are removed and the
  684.        library level index is updated _a_u_t_o_m_a_t_i_c_a_l_l_y by a "removeop"
  685.        command.
  686.  
  687.        If for any reason you believe the library level index is out
  688.        of date with the books installed on your system (in
  689.        particular, this could happen if a book or books have been
  690.        removed by a means other than using the _v_e_r_s_i_o_n_s _r_e_m_o_v_e
  691.        command), you can invoke the _i_n_s_i_g_h_t_A_d_m_i_n tool on a specific
  692.        bookshelf (or all bookshelves) to correct the situation.
  693.        See the man page for _i_n_s_i_g_h_t_A_d_m_i_n for more details.
  694.  
  695.        ssssuuuu
  696.        iiiinnnnssssiiiigggghhhhttttAAAAddddmmmmiiiinnnn ----aaaavvvvffff ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss////****
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.